home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / prog_c / recio214.zip / HISTORY < prev    next >
Text File  |  1996-06-14  |  12KB  |  260 lines
  1. recio, Version 2.14, Release June 14, 1996.
  2. Copyright (C) 1994-1996, William Pierpoint.
  3.  
  4. HISTORY OF RECIO LIBRARY
  5.  
  6. 06/14/96 - vers. 2.14
  7.  
  8.     Added right padding to rcputt(), rcputtm() and rcputs() functions.
  9.  
  10. 09/04/95 - vers. 2.13
  11.  
  12.     Fixed bugs in rsetrecstr(), rcgett(), and rgett() functions.
  13.     Revised rfixt() function.
  14.  
  15.     Revised algorithm within sftotm() function in rgett.c file to do 
  16.     a better job of parsing incomplete time data.
  17.  
  18.     Added macro RECBEGYR and function rsetbegyr().  These control the 
  19.     interpretation of time data that is read by the %y format.  RECBEGYR 
  20.     defaults to 1951.  In other words, the %y input corresponds to the 
  21.     years from 1951 to 2050.  Note that time_t type variables may not 
  22.     be able to represent the complete range, but that you should not have 
  23.     this limitation if using struct tm type variables.  To represent a 
  24.     different range of years, you can change the beginning year of the 
  25.     range by using the rsetbegyr function.
  26.     
  27.     Examples: 1/1/51 -> Jan 1, 1951
  28.             12/31/99 -> Dec 31, 1999
  29.               1/1/00 -> Jan 1, 2000
  30.             12/31/50 -> Dec 31, 2050
  31.  
  32.     Changed EINVDAT to EDOM for ANSI-C compatibility.  
  33.     
  34.     Changed abort() to exit(EXIT_FAILURE) so that streams are flushed 
  35.     upon abnormal program termination.
  36.     
  37.     Improved portability by moving all compiler dependencies to recio.h.
  38.  
  39. 01/29/95 - vers. 2.12
  40.  
  41.     New improved field parsing engine derived from regular expression 
  42.     specification is discussed in section 2.4 of design.txt.  Primary 
  43.     changes are:
  44.     
  45.         * When the field delimiter is not whitespace and the text
  46.           delimiter is whitespace (or anytime the text delimiter 
  47.           is not used even if defined as non-whitespace), leading
  48.           and lagging whitespace are not trimmed from a string field.
  49.     
  50.         * When the text delimiter is not whitespace, the text 
  51.           delimiter can be included as part of a field provided it 
  52.           is not followed by the field termination sequence.  The 
  53.           field termination sequence consists of the text delimiter 
  54.           followed by optional whitespace followed by either the 
  55.           field delimiter or the end of the record.  To illustrate 
  56.           for comma delimited fields with quoted text, the following 
  57.           is only one field: "K&R wrote, "Hello, World"".
  58.     
  59.         * When the text delimiter is the double quote character,
  60.           quoted text within the field is treated as a single word.  
  61.           The comma-delimited example "Use case "1", okay?" parses 
  62.           to one field.
  63.           
  64.         * Fixed a bug in how the rnumfld function counts fields.  
  65.           When the field delimiter is whitespace, the rnumfld function 
  66.           would count any trailing whitespace in the last field as an 
  67.           extra empty field.  The rnumfld function no longer counts any 
  68.           empty fields when whitespace is used as the field separator 
  69.           because empty fields are undetectable in this situation.
  70.     
  71.     An expanded discussion of the ltoa and ultoa functions can now be 
  72.     found in section 3.6 of design.txt.  Included simple ltoa and ultoa 
  73.     code for compilers that don't have these functions.
  74.  
  75. 12/26/94 - vers. 2.11
  76.  
  77.     Fixed some typos in spec.txt.  Added section 3.6 to design.txt.  
  78.     Made some minor stylistic improvements to the source code.
  79.  
  80. 11/2/94 - vers. 2.10
  81.  
  82.     Added new time fields.  Can input and output times using either 
  83.     the time_t or struct tm types and in various user specified formats.  
  84.     New modules are rgett.c, rputt.c, rcgett.c, and rcputt.c.
  85.  
  86.     Time formats are specified using a subset of the specifiers 
  87.     from the ANSI-C strftime function.  Supported specifiers are:
  88.         %d - day of month (1-31)
  89.         %H - hour from 24-hour clock (0-23)
  90.         %m - month (1-12)
  91.         %M - minute (0-59)
  92.         %s - second (0-61)
  93.         %y - year without century (00-99)
  94.         %Y - year with century (e.g. 1994)
  95.  
  96.     The default time format is "%m/%d/%y".  Can override the format on 
  97.     any record stream with a new format using the rsettmfmt function.
  98.  
  99.     Added new warning macro constant R_WTMFMT.  R_WTMFMT indicates that 
  100.     the time data was incomplete (i.e. any element of time format not 
  101.     matched against data).  Also new macro constants R_WFAULT and R_EFAULT 
  102.     added for use by application specific functions.
  103.  
  104.     Data written to an output stream can now be written without field and 
  105.     text delimiters.  Just set the field and text delimiters to the null 
  106.     character.
  107.  
  108. 10/10/94 - vers 2.04
  109.  
  110.     Added new string functions scntrimbegs, scntrimends, and scntrims 
  111.     to rstr.c file.
  112.  
  113.     Fixed minor bug in _rfldstr function in rget.c file.
  114.  
  115.     Changed return type for rskipfld and rskipnfld to unsigned, and  
  116.     num parameter in rskipnfld to unsigned.  Functions now return 
  117.     zero on error.
  118.  
  119.     Added new functions rnumfld, rgetfldpos, and rsetfldpos to rget.c
  120.     file.
  121.  
  122. 10/02/94 - vers 2.03
  123.  
  124.   Eliminated error return values for most functions.  This promotes a 
  125.   programming style that makes use of the callback error function as the 
  126.   preferred way to handle errors.  For lint users, reduces the number of 
  127.   warnings.
  128.  
  129.   Added macro ristxtfld.  If ristxtfld macro returns non-zero, then the 
  130.   current field (the field most recently input or output) was quoted with 
  131.   the text character delimiter (if not white space).  If ristxtfld macro 
  132.   returns zero, then the current field was not quoted.
  133.  
  134.   Added macro rresetrec.  Use of the rresetrec macro allows you to read 
  135.   the fields from the record buffer multiple times.  For example, you 
  136.   could first use rskipnfld to determine the number of fields, then use 
  137.   rresetrec to reset back to the beginning of the record buffer, and 
  138.   finally read in each field until you have reached the number of fields.
  139.  
  140.   Added modules remsg.c and rwmsg.c containing simple callback functions 
  141.   rerrmsg and rwarnmsg for reporting errors and warnings respectively.  
  142.   You may wish to use these functions during the initial prototyping stage 
  143.   of software development.  In the later stages of development, you can 
  144.   substitute more robust error and warning message functions.  Also added 
  145.   the rinit function that registers the error and warning message functions.  
  146.   It just calls rseterrfn and rsetwarnfn, but may be easier to remember.
  147.  
  148.   Added module rstr.c.  This module contains a small set of string functions 
  149.   that are needed by rget.c.  You may also find them useful in your programs.
  150.   See section 7 of the ascii file USAGE.TXT for more details.
  151.  
  152. 05/02/94 - vers 2.02
  153.  
  154.   Handling of errno made more reliable and more portable.  Some Borland C 
  155.   conversion functions clear errno first, some do not.  Where errno is 
  156.   checked after a conversion, cleared errno before conversion.
  157.  
  158.   Reduced code size of numeric field function modules by one-third by 
  159.   eliminating the macro emulation of function templates.  Number of header 
  160.   files reduced from nine to one.
  161.  
  162. 04/22/94 - vers 2.01
  163.  
  164.   Added rsetrecstr function to rget.c.  Sometimes it is handy to stuff a 
  165.   record buffer with your own string, then let the field input functions 
  166.   scan it.  
  167.   
  168.   Added mode check to several rget.c functions to ensure an error will be 
  169.   generated if these input functions are mistakenly used in an output stream.
  170.  
  171.   Fixed bugs in rwarn.c.  Warnings were not being cleared or reset correctly.
  172.  
  173. 04/15/94 - vers 2.00
  174.  
  175.   RECIO can now write as well as read.  Over 25 new functions added.
  176.  
  177.   New record streams that are always open are recout, recerr, and recprn.
  178.   New predefined context numbers are RECOUT, RECERR, and RECPRN.
  179.  
  180.   ROPEN_MAX increased from 5 to 8.
  181.  
  182.   New symbolic error constants are: 
  183.     R_EINVMOD - tried to read file opened in write mode, or vice versa.
  184.     R_ENOPUT  - unable to output data.
  185.  
  186.   New callback warning function and associated warning functions.
  187.   Now all empty data strings are trapped as warnings.  Application can
  188.   choose to handle them or to ignore them.  Failure of atexit function 
  189.   is changed from an error to a warning.
  190.  
  191.   New symbolic warning constants:
  192.     R_WEMPSTR - data string is empty.
  193.     R_WWIDTH  - data too wide for columnar output.
  194.     R_WNOREG  - unable to register exit function with atexit().
  195.                 (changed from error symbolic constant R_ENOREG).
  196.  
  197. 04/8/94 - vers 1.20
  198.  
  199.   Created new rerrstr and rstrerror functions.  Simplified TESTCH.C and 
  200.   TESTCO.C code by using rerrstr.
  201.  
  202.   Changed the specification and code for the rgets and rcgets functions to 
  203.   return a pointer to an empty string (rather than a null pointer) on error.  
  204.   This will help reduce null pointer errors in application programs. 
  205.  
  206.   Changed the specification and code for the rgetrec function.  The rgetrec 
  207.   function now clears the record buffer before the next record is read.  
  208.   This will cause the error number to be set to R_EMISDAT if the application 
  209.   ignores the eof indicator and attempts to read fields in records beyond 
  210.   end-of-file.  There is one exception: if the field just prior to the record 
  211.   buffer string terminator is a string field (which for an empty record buffer 
  212.   is the first field), it won't be trapped as missing data.  This is an 
  213.   unavoidable consequence of allowing empty string fields.  But you shouldn't 
  214.   be ignoring end-of-file anyway!  Also rgetrec continues to increment the 
  215.   record number if the program reads beyond end of file.  This solves an 
  216.   "off by one" bug when the file ends prematurely.
  217.  
  218.   Developed the dif program to locate line where two text files first 
  219.   differ.  Inserted dif source into TUTOR.TXT to illustrate a very simple
  220.   callback error function.  Substituted the dif program for the cmp program 
  221.   in regression test TEST.BAT.
  222.  
  223.  
  224. 04/5/94 - vers 1.11
  225.  
  226.   When is the minimum not the minimum?  MIN values in <float.h> are defined 
  227.   differently than in <limits.h>.  Fixed code to match definitions in 
  228.   ANSI X3.159-1989 Section 2.2.4.2.
  229.   
  230.   RECIO now tests for underflow and overflow of all floating point numbers 
  231.   input.  Test results TESTCH.OUT shows when overflow and underflow occur.
  232.   
  233.   Created new rfix functions to provide a quick way to fix overflows and 
  234.   underflows, and to get callback error functions up and running more 
  235.   quickly.
  236.  
  237.  
  238. 03/28/94 - vers 1.10
  239.  
  240.   Created single precision floating point functions rgetf() and rcgetf().
  241.  
  242.   Created functions rsetbegcolno() and rbegcolno() to make it easy to 
  243.   have column numbering start at either 0 or 1.  Default is 0.
  244.  
  245.   Created program TESTCO to test column delimited fields; enhanced test 
  246.   program TESTCH for character delimited fields.
  247.   
  248.   Created new symbolic error constants for record streams.  Program must 
  249.   use symbolic constants starting with R_ (such as R_EINVDAT) for valid 
  250.   record streams; use errno constants (such as ENOMEM) for invalid record 
  251.   streams.  New error checking provides better reporting and portability.
  252.   New symbolic error constants are not compatible with version 1.00; 
  253.   some rework of version 1.00 callback error functions required.
  254.  
  255.   Fixed some bugs in the column delimited functions.
  256.  
  257. 03/23/94 - vers 1.00
  258.  
  259.   Initial public release.
  260.